3.6 Org-Plot

Org-Plot can produce 2D and 3D graphs of information stored in org tables using Gnuplot http://www.gnuplot.info/ and gnuplot-mode http://xafs.org/BruceRavel/GnuplotMode. To see this in action, ensure that you have both Gnuplot and Gnuplot mode installed on your system, then call org-plot/gnuplot on the following table.

#+PLOT: title:"Citas" ind:1 deps:(3) type:2d with:histograms set:"yrange [0:]"
| Sede      | Max cites | H-index |
|-----------+-----------+---------|
| Chile     |    257.72 |   21.39 |
| Leeds     |    165.77 |   19.68 |
| Sao Paolo |     71.00 |   11.50 |
| Stockholm |    134.19 |   14.33 |
| Morelia   |    257.56 |   17.67 |

Notice that Org Plot is smart enough to apply the table’s headers as labels. Further control over the labels, type, content, and appearance of plots can be exercised through the #+PLOT: lines preceding a table. See below for a complete list of Org-plot options. For more information and examples see the Org-plot tutorial at http://orgmode.org/worg/org-tutorials/org-plot.html.

Plot Options

set

Specify any gnuplot option to be set when graphing.

title

Specify the title of the plot.

ind

Specify which column of the table to use as the x axis.

deps

Specify the columns to graph as a Lisp style list, surrounded by parentheses and separated by spaces for example dep:(3 4) to graph the third and fourth columns (defaults to graphing all other columns aside from the ind column).

type

Specify whether the plot will be 2d, 3d, or grid.

with

Specify a with option to be inserted for every col being plotted (e.g., lines, points, boxes, impulses, etc...). Defaults to lines.

file

If you want to plot to a file, specify "path/to/desired/output-file".

labels

List of labels to be used for the deps (defaults to the column headers if they exist).

line

Specify an entire line to be inserted in the Gnuplot script.

map

When plotting 3d or grid types, set this to t to graph a flat mapping rather than a 3d slope.

timefmt

Specify format of Org mode timestamps as they will be parsed by Gnuplot. Defaults to ‘%Y-%m-%d-%H:%M:%S’.

script

If you want total control, you can specify a script file (place the file name between double-quotes) which will be used to plot. Before plotting, every instance of $datafile in the specified script will be replaced with the path to the generated data file. Note: even if you set this option, you may still want to specify the plot type, as that can impact the content of the data file.